home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / tribbs / klpak12.zip / KLPAK.DOC < prev    next >
Text File  |  1996-02-26  |  20KB  |  576 lines
  1.                                 
  2.                                 
  3.                                 
  4.                                 
  5.                                 
  6.                                 
  7.                                 
  8.                                    KLPAK 1.2
  9.                         Utility Package for TriBBS 10.0
  10.                         
  11.                        Copyright (c) 1995 Kenneth Lovin
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  ----------------------------------------------------------------------------
  23.  
  24.  
  25.                                     
  26.                                   WARRANTY
  27.                                   --------
  28.  
  29.     KLPAK is distributed without warranty.  In no event will I, Kenneth Lovin, 
  30.     be liable to you for damages, including any loss of profits, lost 
  31.     savings, or other incidental or consequential damages arising out of 
  32.     your use of or inability to use the programs included in this package, 
  33.     even if I have been advised of the possibility of such damages.  I will 
  34.     not be liable for any such claim by any other party.
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  ----------------------------------------------------------------------------
  43.  ----------------------------------------------------------------------------                       
  44.  
  45.  
  46.                        
  47.                      +++++++++++++++++++++++++++++++++++++
  48.                      +           REGISTRATION            +
  49.                      +++++++++++++++++++++++++++++++++++++
  50.     
  51.  
  52.  This software is part of a package, KLPAK 1.2, it may not be distributed 
  53.  seperately from the rest of the software package.  Registration for the
  54.  package is addressed in the file, included in the package, named KLPAK.REG.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  ----------------------------------------------------------------------------
  64.  ----------------------------------------------------------------------------
  65.                            Table of Contents
  66.     
  67.                Compatability       ................. 1
  68.                Configuration File  ............... 2-8
  69.                
  70.                ANS2MSG
  71.                  Description       ................. 9       
  72.                  Command Line      ................. 9
  73.                BDG
  74.                  Description       ................ 10
  75.                  Command Line      ................ 10
  76.                CLIST
  77.                  Description       ................ 11
  78.                  Command Line      ................ 11
  79.                FLISTER
  80.                  Description       ................ 12
  81.                  Command Line      ................ 12 
  82.  
  83.  
  84.  ----------------------------------------------------------------------------               
  85.  ----------------------------------------------------------------------------
  86.                       Table of Contents...continued
  87.                
  88.                
  89.                
  90.                FSIZER
  91.                  Description       ................ 13
  92.                  Command Line      ................ 13
  93.                PEDIT
  94.                  Description       ................ 14
  95.                  Command Line      ................ 14
  96.                SYSCHAT             See SYSCHAT.TXT
  97.                TMU
  98.                  Description       ................ 15
  99.                  Command Line      ................ 16
  100.                  Restoring backups ................ 17
  101.                
  102.  
  103.  
  104.  
  105.  ----------------------------------------------------------------------------
  106.  ----------------------------------------------------------------------------
  107.                       Table of Contents...continued
  108.  
  109.  
  110.  
  111.                TTM
  112.                  Description       ................ 18
  113.                  Command Line      ................ 18
  114.                  Using TTM as a New User Greeter .. 19
  115.                SC
  116.                  Description       ................ 20
  117.                  Command Line      ................ 20
  118.  
  119.                Contacting The Author............... 21
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  ----------------------------------------------------------------------------    
  127.  ----------------------------------------------------------------------------    
  128.                                     - 1 -
  129.     
  130.     
  131.                                 COMPATIBILITY
  132.     
  133.     
  134.     
  135.     
  136.     These programs are written for TriBBS 10.0.  They WILL NOT work with 
  137.     earlier versions of TriBBS.  They have been tested with the lastest
  138.     beta of TriBBS 10.0.
  139.  
  140.     
  141.     
  142.     
  143.     
  144.     
  145.     
  146.     
  147.  ----------------------------------------------------------------------------    
  148.  ----------------------------------------------------------------------------    
  149.                                     - 2 -
  150.     
  151.                               CONFIGURATION FILE
  152.  
  153.  
  154.          The configuration file is a very important component of this
  155.          package.  Please read the following description of it carefully.
  156.          Lines 1 through 5 are for the programs that run as doors.  This
  157.          requires that the first five lines of the configuration file contain
  158.          the following parameters, blank lines are NOT allowed.  Blank lines
  159.          before line 6 in the file will cause the programs that run as doors
  160.          to not run correctly, or not at all.
  161.          
  162.      
  163.          Line 1:   Door data file type.
  164.          Line 2:   Path to the door data file(s).
  165.          Line 3:   BBS name.
  166.          Line 4:   Sysop's name.
  167.          Line 5:   Locked baud rate.
  168.      
  169.                                     - 3 -
  170.  
  171.          As illustrated above, the door data file type is specified in 
  172.          line 1 and can be one of the following values:
  173.  
  174.      
  175.          PCB    for PCBoard
  176.          GAP    for GAP (DOOR.SYS)
  177.          SF     for Spitfire
  178.          
  179.          RBBS   for RBBS
  180.          WC     for WildCat!
  181.          TRIBBS for TriBBS
  182.          WWIV   for WWIV
  183.      
  184.  
  185.          Line 2 is the directory where the drop files are located.  Line 3 
  186.          should be your BBS name as it appears in your drop files.  Line 4 
  187.          should be the Sysop's name as it appears in the drop files. The 
  188.          locked baud rate is specified in line 5.  If you don't lock your 
  189.          serial port, you must specify 0 for the locked baud rate.  
  190.      
  191.                                     - 4 -
  192.  
  193.  
  194.  
  195.   
  196.   NOTE:  Although many door formats do pass the locked baud rate in the
  197.          door data files, some older formats such as RBBS do not.  For 
  198.          conformity, the library used to write the door requires that you 
  199.          specify the locked baud rate in line 5 and ignores any value 
  200.          passed in the door data files.
  201.  
  202.  
  203.          The following is a sample door configuration file:
  204.      
  205.          TRIBBS       
  206.          C:\TRIBBS\
  207.          The Workbench
  208.          Kenneth Lovin
  209.          19200
  210.          
  211.  
  212.                                     - 5 -
  213.          
  214.          RESPONSEFILE=C:\TRIBBS\MWORK\Q1.ANS
  215.  
  216.          RESPONSEFILE is the questionaire response file you wish ANS2MSG
  217.          to check to see if the caller answered while they were online.  You
  218.          must include the path in this parameter.
  219.  
  220.  
  221.          A2MCONF=1
  222.  
  223.          A2MCONF is the conference you wish ANS2MSG to post the questionaire
  224.          answers to.
  225.  
  226.          
  227.          NODE=1
  228.  
  229.          NODE is the node this configuration file applies to, you should
  230.          have a different configuration file for each node you have.  This
  231.          parameter applies to ALL utilities in this package.
  232.  
  233.                                     - 6 -
  234.          
  235.          NODE1MAINDIRECTORY=C:\TRIBBS
  236.  
  237.          NODE1MAINDIRECTORY is where you specify the path to TriBBSs node 1.
  238.          This parameter is used my ALL utilities in this package.
  239.  
  240.          
  241.          SCNOTIFY=YES
  242.  
  243.          SCNOTIFY is used by the SC security checker.  Valid values are
  244.          YES and NO, if you specify YES the program will notify you in a
  245.          message conference when a user fails the security check.
  246.          
  247.          
  248.          SCCONF=5
  249.  
  250.          SCCONF is the conference you want the security checker to post the
  251.          message notifing you of a failed security check.
  252.  
  253.  
  254.                                     - 7 -
  255.  
  256.          SCPERCENTAGE=100
  257.  
  258.          SCPERCENTAGE is the percentage of the time you want the SC program
  259.          to check callers.  Valid values are 1 to 100.
  260.  
  261.  
  262.          SCIGNORESECLEVEL=9999
  263.  
  264.          SCIGNORESECLEVEL is the security level at which the SC program stops
  265.          screening callers.  If a callers security level is equal to or
  266.          higher than SCIGNORESECLEVEL they will not be screen no matter what
  267.          the percentage is set at.
  268.  
  269.          
  270.          BDGFILE=GREET.BBS
  271.  
  272.          BDGFILE is the file you wish the BDG program to use as the display
  273.          to the user enjoying a birthday.
  274.  
  275.                                     - 8 -
  276.          
  277.  
  278.          CLISTFILE=C:\TRIBBS\DISPLAY\BULLET4.BBS
  279.  
  280.          CLISTFILE is the name of the bulletin you wish the CLIST program to
  281.          create as a listing of the last 10 callers.
  282.  
  283.  
  284.          CLISTMAXCALLERS=10
  285.  
  286.          CLISTMAXCALLERS is the maximum number of callers you want in the 
  287.          list the CLIST program generates.  The default is 10 for the 
  288.          registered version of the program.  If you are using the unregistered
  289.          version the maximum number is 5.
  290.  
  291.          
  292.          REGNUM=0
  293.  
  294.          REGNUM is YOUR registration number.
  295.  ----------------------------------------------------------------------------    
  296.  ----------------------------------------------------------------------------    
  297.                                     - 9 -    
  298.  
  299.                                    ANS2MSG
  300.                               
  301.          
  302.         
  303.         ANS2MSG is a utility that can post a questionaires response file
  304.     to a specified message conference.  It takes the pain out of searching
  305.     through the response file manually, since the users response is auto-
  306.     matically posted in a message to the sysop.  You should run ANS2MSG
  307.     in your BETWEEN.BAT.
  308.                               
  309.                               
  310.                               
  311.     Command Line:
  312.  
  313.     ANS2MSG config_file
  314.                               
  315.  
  316.  ----------------------------------------------------------------------------
  317.  ----------------------------------------------------------------------------
  318.                                     - 10 -
  319.  
  320.                                      BDG
  321.  
  322.  
  323.         BDG is a door program that will display an @X-color coded file to
  324.     a user if it's his/her birthday, at logon.  The program also recognizes
  325.     the "@FIRST@" at-code too, so you can include the users first name in 
  326.     the display for a more personal touch.  The program will display the 
  327.     greet each time the person logs on that day.  You should run BDG from 
  328.     your LOGON.BAT file.
  329.     
  330.  
  331.     Command Line:
  332.  
  333.     BDG config_file [NonStandardIRQ]
  334.  
  335.  
  336.  
  337.  ----------------------------------------------------------------------------
  338.  ----------------------------------------------------------------------------
  339.                                     - 11 -
  340.  
  341.                                     CLIST
  342.  
  343.         CLIST will generate an @X-color coded bulletin containing the last
  344.     10 callers.  Until you register it will only display the last 5 callers. 
  345.     It gets all the caller info from your CALLERS.LOG.  CLIST creates a file, 
  346.     CLIST.DAT, in the directory the executable is located in.  This file 
  347.     contains the info for the callers that the program uses to generate the 
  348.     bulletin.  If you wish to exclude a user from being listed by CLIST, 
  349.     CLIST looks for a file name EXEMPT.LST in the same directory the 
  350.     executable is in.  Simply fire up your favorite editor and add the user's 
  351.     name to the file, make sure you save it as an ASCII file.  You should run 
  352.     CLIST from your BETWEEN.BAT.  If you change your CLISTMAXCALLERS number in 
  353.     you config file, the program will reset the data file.
  354.     
  355.     Command Line:
  356.        
  357.        CLIST config_file 
  358.  ----------------------------------------------------------------------------
  359.  ----------------------------------------------------------------------------
  360.                                     - 12 -
  361.  
  362.                                     FLISTER
  363.  
  364.  
  365.         FLISTER will generate a formatted text file containing a file list 
  366.     from the specified file area, or "ALL".
  367.  
  368.  
  369.  
  370.  
  371.     Command Line:
  372.  
  373.     FLISTER config_file file_area
  374.  
  375.     Specify "ALL" as the "file_area" argument if you wish FLISTER to generate
  376.     a complete listing for all your file areas.
  377.  
  378.  
  379.  ----------------------------------------------------------------------------
  380.  ----------------------------------------------------------------------------
  381.                                     - 13 -
  382.  
  383.                                    FSIZER
  384.  
  385.  
  386.         FSIZER is a utility that fixes files in a file list that have
  387.     an incorrect file size in the FILES.LST file.  If you run a utility
  388.     to generate a master file list you know what this utility if for.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.     Command Line:
  396.  
  397.     FSIZER config_file file_area
  398.  
  399.  
  400.  ----------------------------------------------------------------------------
  401.  ----------------------------------------------------------------------------    
  402.                                     - 14 -    
  403.  
  404.                                     PEDIT
  405.  
  406.  
  407.         PEDIT is a utility which allows you to edit a specified users
  408.     message pointers.  From time to time a users message pointers will
  409.     become corrupt, when this happens usually using the builtin TriBBS
  410.     packers will work, but sometimes they don't.  When the built-in packers
  411.     don't correct the corrupt message pointers this utility will allow you
  412.     to do it by hand.
  413.  
  414.  
  415.      Command Line:
  416.  
  417.      PEDIT config_file "User Name"
  418.  
  419.      IMPORTANT: Remember to enclose the user name in quotes.
  420.  
  421.  ----------------------------------------------------------------------------    
  422.  ----------------------------------------------------------------------------    
  423.                                     - 15 -
  424.                               
  425.                                      TMU
  426.                               
  427.     
  428.     TMU is a utility program that fixes messages in any TriBBS message 
  429.     conference that are over TriBBS's 72 character limit.  Messages with
  430.     lines of text greater than 72 characters cause problems when quoting
  431.     from within the TriBBS editor.  TMU reformats these messages to fix
  432.     this problem.  TMU will wrap the text accordingly if it's a quoted 
  433.     message or not, as long a the quote character is the '>'.  I wrote this
  434.     program because locally the system that all the sysops pull our local
  435.     net from is an Amiga and when TriBBS imports the messages from the net
  436.     it wraps the text incorrectly, making quoting annoying because the quote
  437.     display looks like this:
  438.  
  439.     1: text that is too long for TriBBS to wrap
  440.     correctly.
  441.     2: See what I mean?
  442.  ----------------------------------------------------------------------------       
  443.  ----------------------------------------------------------------------------       
  444.                                     - 16 -
  445.                                      
  446.                                      TMU
  447.     
  448.     Command Line:
  449.  
  450.     TMU config_file conf_number
  451.  
  452.     Where "config_file" is the name of your configuration file, which is 
  453.     covered in detail in on pages 2-8 of this file, and "conf_num" is which 
  454.     message conference you want to run the program on.
  455.     
  456.     It's a good idea, if you have networked conferences to run TMU after you
  457.     have imported messages.
  458.  
  459.     
  460.  
  461.     
  462.     
  463.  ----------------------------------------------------------------------------           
  464.  ----------------------------------------------------------------------------           
  465.                                     - 17 -
  466.  
  467.                                      TMU
  468.  
  469.                                RESTORING BACKUPS
  470.  
  471.  
  472.     TMU creates backups of the conferences ".TXT" and ".HDR" files which 
  473.     will have the extensions ".BXT" and ".BDR" respectively.  If you need 
  474.     to restore a conference from a backup simply copy the Mxxxx.BXT over
  475.     the existing Mxxxx.TXT file and copy the Mxxxx.BDR over the Mxxxx.HDR,
  476.     where "xxxx" refers to the conference number.  If previous backups 
  477.     already exist in your MWORK directory created by TMU the program will 
  478.     overwrite them.
  479.  
  480.                               
  481.  
  482.  
  483.  
  484.  ----------------------------------------------------------------------------                                     
  485.  ----------------------------------------------------------------------------                                     
  486.                                     - 18 -
  487.  
  488.                                      TTM
  489.  
  490.  
  491.         TTM is a dual-purpose program, it allows you to post a text file
  492.     to a message.  It also can be used as a new user greeter in your 
  493.     NEWUSER.BAT file.
  494.  
  495.     
  496.     Command Line for Sending a Text file:
  497.  
  498.     
  499.     TTM config_file conf "User Name" "Subject" Private text_file
  500.                               
  501.  
  502.     Remember to enclose the User name and Subject in quotes.   Valid values
  503.     for the "Private" argument are Y and N.
  504.  
  505.  ----------------------------------------------------------------------------
  506.  ----------------------------------------------------------------------------    
  507.                                     - 19 -    
  508.  
  509.                                      TTM
  510.  
  511.                         USING TTM AS A NEW USER GREETER
  512.     
  513.     TTM can be used to send a special text file to a new user when they
  514.     log on by running it in your NEWUSER.BAT
  515.     
  516.     TTM config_file conf "WHOSONxxxx" "Subject" Private text_file
  517.     
  518.     Specify the "WHOSONxxxx" parameter by specifing the node number like so:
  519.     
  520.     TTM cfg.cfg 1 "WHOSON1" "Welcome!" N C:\TRIBBS\NEWUSER.TXT
  521.     
  522.     This will send the NEWUSER.TXT file to the user on Node 1, so when they
  523.     get to the "Waiting messages" screen they will have a nice greeting from
  524.     you.
  525.     
  526.  ----------------------------------------------------------------------------    
  527.  ----------------------------------------------------------------------------    
  528.                                     - 20 -
  529.  
  530.                                       SC
  531.  
  532.  
  533.         SC will screen callers, asking for their birthdate and phone number
  534.     for verification when they log on.  If they fail the security check SC
  535.     will optionally sent you a note letting you know who failed the security
  536.     check and HANGUP on the caller if they fail.
  537.  
  538.  
  539.     Command Line:
  540.  
  541.     SC config_file [NonStandardIRQ]
  542.  
  543.     Only specify a Non-standard IRQ if you are using one.
  544.  
  545.  
  546.  
  547.  ----------------------------------------------------------------------------
  548.  ----------------------------------------------------------------------------
  549.                                     - 21 -    
  550.  
  551.                             CONTACTING THE AUTHOR
  552.  
  553.       Registration information can be obtained in the KLPAK.REG file.
  554.       
  555.       If you have questions about this program I can be reached on one 
  556.       of the following BBSs:
  557.  
  558.  
  559.                      Mind Threads --- (910) 582-4372
  560.                           Hamlet, North Carolina
  561.                             Gene Mercer, Sysop
  562.  
  563.                   
  564.                   The Lonely Nut Tavern --- (910) 895-2184 
  565.                            Rockingham, North Carolina      
  566.                             Lee Montrose, Sysop        
  567.       
  568.       
  569.       Remember, if you do call to ask a question or to obtain a registration
  570.       number, DO NOT POST YOUR MESSAGE TO THE SYSOP, post it to:
  571.       
  572.       KENNETH LOVIN
  573.  
  574.  
  575. - End of Doc -
  576.